TO_BCD_WORD block

Short summary

Name	`TO_BCD_WORD`
→POU type	→function
Category	IEC-block, Convert
Conform to →IEC-standard	no restrictions
Graphical interface
Available since	version 1.22.0 (for Neuron Power Engineer)

Functionality

The block converts a decimal value into a binary coded decimal value (a →BCD-value).

At input IN, connect the decimal value that should be converted. If the decimal value has more than 4 digits, only the 4 rightmost digits are considered. The remaining digits are not accepted by the data type of the return value. In case of decimal values < 0, the block always returns value 0.

Inputs, return value

	Identifier	→Data type	Description
Inputs:	`IN`	`USINT`, `UINT`, `UDINT`, `ULINT`, `SINT`, `INT`, `DINT` or `LINT`(corresponds to →generic data type `ANY_INT`)	decimal input value
Return value:	–	`WORD`

Input EN and output ENO are available when →calling the block. See "Execution control: EN, ENO" for information on input EN and output ENO.

See:

"Blocks for safe logic" whether this block is supported for developing safety-relevant applications.
"Highlighting safe logic in the FBD-editor" for the effects when using the block as a block for safe logic.

Example for usage within ST-editor

PROGRAM Test

VAR

        result1, result2 : WORD;

    END_VAR

    result1 := TO_BCD_WORD(IN := 4_321);       (* The variable 'result' evaluates to '16#4321' (decimal: 17_185). *)

    result2 := TO_BCD_WORD(IN := 32_767);      (* The variable 'result' evaluates to '16#2767' (decimal: 10_087). *)

(* Note: The single underscore character '_' has been inserted as separator to make the decimal values in the sample more readable. *)

END_PROGRAM

When creating your application within the ST-editor, enter a call of a block by typing the text as requested by the syntax or use Content Assist.